This page last changed on Jun 29, 2007 by ritchiem.

Configuring Qpid Management Console

QPID has a management interface that exposes . By default the management interface is enabled but it can also be disabled by modifying the management element in config.xml.

When starting the broker, the following system properties need to be set by setting the environment variable QPID_OPTS:

QPID_OPTS="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false"

Note that you should only use these settings for non-production systems. For production deployments you should use authentication !

You can find out more about the features exposed by the Qpid JMS interfaces here.

Using Eclipse RCP

Installing the Qpid Management Console (eclipse RCP)

Unzip the management eclipse plugin zip for windows in a dir (eg C:/). A dir with name qpidmc (eg C:/qpidmc) will get created.

To run the RCP from command prompt, set the environment variable QPIDMC_HOME to installation dir (eg. QPIDMC_HOME=C:/qpidmc)  and include $QPIDMC_HOME/bin in your PATH.

Running the Qpid Management Console (eclipse RCP)

To run this application on windows, run any of these scripts-

qpidmc.bat (windows command prompt)

qpidmc.sh  (cygwin) 

For running on unix, use the scritps for particular windowing system
qpidmc_<windowing system>.sh (eg. qpidmc_motif.sh)

Using the Qpid Management Console (eclipse RCP)

Please see [attachment |^Qpid_Management_Console.doc] for using this Eclipse RCP.  Attchment contains some of the screenshots of Qpid Management Console (Eclipse RCP) .

Using JConsole

JConsole is a management tool that comes with the Java Runtime Environment and provides a very simple view of managed beans. It requires no special configuration to be used with QPID.

To attach to a running broker simply enter the host and port details on the JConsole connect dialog. The port should be the same as the one specified in the system property com.sun.management.jmxremote.port.

Once you are connected expand the tree nodes marked "org.apache".

Please see attachment for some of the [screenshots|^Qpid_using_jconsole.doc] of using jconsole for Qpid.

Using HermesJMS

HermesJMS also offers integration with the Qpid management interfaces. You can get instructions and more information from http://wiki.apache.org/qpid/HermesJMS.

Using MC4J

MC4J is an alternative management tool. It provide a richer "dashboard" that can customise the raw MBeans.

Installation

  • First download and install MC4J for your platform. Version 1.2 beta 9 is the latest version that has been tested.
  • Copy the directory blaze/java/management/mc4j into the directory <MC4J-Installation>/dashboards

Configuration

You should create a connection the JVM to be managed. Using the Management->Create Server Connection menu option. The connection URL should be of the form: service:jmx:rmi:///jndi/rmi://localhost:8999/jmxrmi making the appropriate host and post changes.

Operation

You can view tabular summaries of the queues, exchanges and connections using the Global Dashboards->QPID tree view. To drill down on individual beans you can right click on the bean. This will show any available graphs too.

Document generated by Confluence on Apr 22, 2008 02:47